home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / osi / isode / bulkload.README < prev    next >
Encoding:
Text File  |  1993-04-25  |  6.7 KB  |  212 lines
  1. PARADISE newdmdiff and bulkload : BETA RELEASE 4
  2. ------------------------------------------------
  3.  
  4. Main changes :-
  5.  
  6.     ********************************************************
  7.     * The attribute "nonMasterUpdatedAttrType" replaces    *
  8.     * "masterUpdatedAttrType" - bulk management function   *
  9.     * 7 may be used on Directory sub-trees to carry out    *
  10.     * the replacement for entries that were loaded by      *
  11.     * bulkload. Alternatively the option can just remove   *
  12.     * the attribute                           *
  13.     ********************************************************
  14.     
  15.     a) Object class list insertion when creating an entry.
  16.         List insertion requires the presence of either a 
  17.        structural object class such as "person" or of the new 
  18.        bulk attribute "bulkEntryClass" when creating an entry.
  19.  
  20.     b) 6 management functions have been added to report on 
  21.        master/create/delete sources; to find "expired" entries ;
  22.        to "dump" a sub-tree to a file ; and three options to
  23.        compare a full data source file against the Directory.
  24.  
  25.        The bulkmanagement mode of bulkload is entered using
  26.  
  27.            bulkload -m
  28.         
  29.     c) -u and -p command line parameters to allow user name
  30.        and password input.
  31.  
  32.     d) Newdmdiff has -s and -so options :- used if delete attribute
  33.        requests are to be output instead of delete entry ones (for
  34.        secondary data sources that only add attributes as
  35.        opposed to requesting the creation of entries.)
  36.  
  37.        Newdmdiff no longer inserts a remove attribute request if
  38.        all of the values for a given attribute are absent in the
  39.        new file. It is up to Bulkload to replace a remove value
  40.        that is to delete the last value of a Directory attribute with
  41.        a remove attribute request.
  42.     
  43.     e) Support is provided for data sources that can not be readily 
  44.        structured to match the Directory e.g. a telephone data
  45.        source that holds data for all of the organisational units of 
  46.        the Registry in one long list, when the Directory holds
  47.        them as distinct OUs.
  48.  
  49.        A sub-directory list may be defined to indicate precisely
  50.        which OUs a given data source is to be applied to e.g.
  51.  
  52.        if the Registry units are held in the Directory as
  53.  
  54.                   o=UCL
  55.  
  56.        ou=Art ou=Accounts ou=Exams ou=Records ou=Zoology
  57.  
  58.        then we could update the Registry OUs using..
  59.        
  60.         rootedAt = c=GB@o=UCL@bulkSubDirList=RegistryList
  61.  
  62.         # updates for the Registry OUs..
  63.  
  64.        Where the RegistryList (which must be held at {c=GB@o=UCL}
  65.        given the above rootedAt) is defined as..
  66.  
  67.            bulkSubDirList=RegistryList
  68.         bulkSubTreeDN= c=GB@o=UCL
  69.         bulkSubTreeDNextension= ou=Accounts
  70.         bulkSubTreeDNextension= ou=Exams
  71.         bulkSubTreeDNextension= ou=Records.
  72.  
  73.        Whilst if the Registry had been held in the Directory as
  74.  
  75.                   o=UCL
  76.                
  77.                   ou=Registry
  78.  
  79.         ou=Accounts ou=Exams ou=Records
  80.  
  81.        then a special "All" sub-directories case could be used..
  82.  
  83.            rootedAt = c=GB@o=UCL@ou=Registry@bulkSubDirList=All
  84.  
  85.         # updates for the Registry OUs..
  86.  
  87.     f) Manual over-ride for non-create or delete sources.
  88.  
  89.     g) Full-stop delimeters within commonName RDN components
  90.        are replaced internally with spaces (though still present
  91.        in output files.)
  92.  
  93.     
  94. make and Makefile will need updating :-
  95.  
  96. make 
  97.     1) specify the TOPDIR and the path name to CONFIG.make.
  98.  
  99. Makefile
  100.     It was clear from the email that I have received that ISODE
  101.     is not always fully installed.
  102.  
  103.     1) For those sites that do not have the include files fully installed
  104.        then you may well have problems with the <isode/quipu/X> include
  105.        statements. Andrew Findlay at Brunel, has suggested that if ISODE
  106.        is not fully installed then use :-
  107.  
  108.             ln -s $TOPDIR/h isode
  109.  
  110.        in the bulkload build directory, where $TOPDIR is the path to the
  111.        ISODE top-level build directory.
  112.        
  113.     2) If libdl.a and libpp.a are unavailable then the MHS syntaxes
  114.        can not be used. Append "-DPPANDDLUNAVAILABLE" to "CFLAGS". 
  115.        Also remove the libraries from "LDLIBS".
  116.  
  117.     3) If libdl.a and libpp.a are available then set up PPDIR accordingly.
  118.        They have there own pointer since a number of sites hold these
  119.        libraries in some very strange places.
  120.        
  121.        Note: PP version 6.4 will have a single library (libpp.a).
  122.  
  123.     4) Make any other required adjustments to the "Lines that will need 
  124.        changing" section.
  125.  
  126. Then use 
  127.  
  128.     ./make all
  129.  
  130. to compile the "newdmdiff" and "bulkload". 
  131.  
  132.  
  133. To install, use
  134.  
  135.     ./make inst-all
  136.  
  137.  
  138. Next insert the oidtable bulk additions as defined in :-
  139.  
  140.     "bulk.oidtable.gen", bulk.oidtable.oc" and "bulk.oidtable.at".
  141.  
  142. Note: 1) updates to oidtable.at..
  143.  
  144.  
  145. nonMasterUpdatedAttrType:    bulkAttributeType.14    :CaseIgnoreString
  146.  
  147. bulkEntryClass:            bulkAttributeType.20    :CaseIgnoreString
  148.  
  149. bulkSubDirList:            bulkAttributeType.25    :CaseIgnoreString
  150. bulkSubTreeDN:            bulkAttributeType.26    :DN
  151. bulkSubTreeDNextension:        bulkAttributeType.27    :DN
  152.  
  153.  
  154. Note: 2) updates to oidtable.oc..
  155.  
  156. "nonMasterUpdatedAttrType" added to the classes that contain "masterUpdatedAttrType".
  157.  
  158. # bulkSubDirList is the entry RDN..
  159. bulkSubDirListClass:    bulkObjectClass.3: top: bulkSubDirList, bulkSubTreeDN, bulkSubTreeDNextension :\
  160.         description, masterUpdatedAttrType, lastModifiedTime, lastModifiedBy, acl
  161.  
  162.  
  163. Note: 3) Documentation
  164.  
  165. The full list of tailor options are described in the documentation
  166. "bulkload.ps" and "bulkload.fig.ps" or the raw ms(with tbl)/fig files
  167. "bulkload.ms" and "bulkload.fig", which are contained in the "docs" sub-directory.
  168.  
  169. Note: 4) for those sites that have a bulkloadtailor file already then the new 
  170. statements are:-
  171.  
  172. #
  173. # Any existing values for an attribute may be cleared down when a master source
  174. # adds a value to the attribute for the first time (i.e. the attribute type
  175. # is listed in the entry's "nonMasterUpdatedAttrType" attribute).
  176. #
  177. Existing attr value may be cleared if master source applies 1st value : YES
  178.  
  179. .. and as required by user (optional)..
  180.  
  181. #
  182. # Auto insertion of missing object classes
  183. #
  184. # autoInsertOnAttrT -    If an add entry request has this attribute type then check
  185. #            for the "autoInsertOnAttrV" value.
  186. # autoInsertOnAttrV -    If the add entry "autoInsertOnAttrT" type has this 
  187. #            attribute value then insert the "autoInsertObjCls" classes.
  188. # autoInsertObjCls  -    Multiple statements containing the object classes to be inserted
  189. #            (if missing) within an add entry request.
  190. #
  191. #
  192. autoInsertOnAttrT    :    bulkEntryClass
  193. autoInsertOnAttrV    :    personClass
  194. autoInsertObjCls    :    person
  195. autoInsertObjCls    :    organizationalPerson
  196. autoInsertObjCls    :    newPilotPerson
  197. autoInsertObjCls    :    pilotObject
  198. autoInsertObjCls    :    quipuObject
  199.  
  200. autoInsertOnAttrT    :    objectClass
  201. autoInsertOnAttrV    :    person
  202. autoInsertObjCls    :    organizationalPerson
  203. autoInsertObjCls    :    quipuObject
  204. autoInsertObjCls    :    pilotObject
  205. autoInsertObjCls    :    newPilotPerson
  206.  
  207.  
  208. ..and for usage with the management functions..
  209.  
  210.  
  211. default DN    :    "c=GB@o=University College London@ou=Computer Science"
  212.